home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / sound / jmplay11.zip / JMPLAYER.DOC < prev    next >
Text File  |  1990-10-14  |  7KB  |  185 lines
  1. User manual for JMPLAYER.EXE , the Noise Tracker player for the Sound Blaster.
  2. Version 1.0 for the EGA/VGA grafix card.
  3.  
  4.  
  5.  
  6.                              Table of Contents
  7.  
  8.  
  9.  
  10.       1 . . . . . . . . . . . Introduction
  11.       2 . . . . . . . . . . . The JMPROG.* file format
  12.       3 . . . . . . . . . . . Keys
  13.       4 . . . . . . . . . . . Command line options
  14.       5 . . . . . . . . . . . Specifications and Tips
  15.       6 . . . . . . . . . . . About Ultra Force + Addresses
  16.       7 . . . . . . . . . . . The end
  17.  
  18.  
  19.  
  20. Part 1 : Introduction.
  21.  
  22. First this important thing : This document was written by a Dutch person , so
  23. it's possible that there are some grammatical or other kind of error's in the
  24. text. But who cares , it's all for free anyway !
  25.  
  26. This program was written for you to enjoy the music of Sound/Noise Tracker,
  27. if you have an AT and a Sound Blaster. 
  28.  
  29. So I (=JM) analyzed the music format of the Noise and Sound Tracker. 
  30. And after some time I wrote this program, which enables you to listen to the 
  31. (sometimes) terrific songs ! 
  32. (See part 6 how to get some of these great songs.)
  33.  
  34. And here it is, JMPLAYER will play any legal Noise/Sound Tracker format 
  35. (15/31 instruments) on the DAC channel of the Sound Blaster.
  36.  
  37. The program uses the so called script files, which contain 1 or more filenames
  38. and other options. (see part 2)
  39.  
  40. Further is it possible to use Pause/Repeat/Fast reverse/Fast forward and other
  41. options while the music is played. (See part 3)
  42.  
  43. The program will scan the paths in the enviroment variable PATH , if it can't 
  44. find JMPLAYER.DAT in the current directory, so you can create different music 
  45. disks , only contaning an extra JMPROG.? file and play them , by coping 
  46. JMPLAYER.EXE & JMPLAYER.DAT in a 'PATH' directory.
  47.  
  48. Before using the program read parts 2,3,4. Part 6 gives your more 
  49. information about the music files and Ultra Force.
  50.  
  51.  
  52. Part 2 : The JMPROG.* file format.
  53.  
  54. The JMPLAYER can play 10 different programs , JMPROG.0 ... JMPROG.9 .
  55. See part 3 and 4 , how to select while running the program or in the command
  56. line.
  57.  
  58. The JMPROG files are normal ASCII text files , contaning no extra symbols. The
  59. program will scan every line for commands. The following commands are possible
  60. 1 : R=n     , n = number of times to repeat the program , a 'A' means always.
  61. 2 : T="..." , when the program is selected the text between quotes is shown.
  62.               Only the first 76 characters are shown , so it got no use to make
  63.               the text length longer.
  64. 3 : ' blabla, comment , the program will skip the rest of the line.
  65. 4 : name    , Name is a legal filename (including path and drive) of the song-
  66.               file to play. Behind the name you can also use some options.
  67.  
  68. The program does verification checks , so make sure you type all the
  69. sentences right: any errors are skipped. There's no difference between
  70. lower/upper case except in the text of the title.
  71.  
  72. Note on 4 :
  73.  
  74. Behind the filename you can use R:n & T:".." (use spaces between options and 
  75. filename). They have the same effect as the main R= & T= , but now for the
  76. current song played. 
  77. (Note: enabling repeat always (A) causes the next song never to be played !)
  78. Important are the extension of the file , because the program will use them to 
  79. make a difference between the diff. formats. Possible extensions are :
  80.  
  81. .NST  :  The noise tracker format (the program checks for 15 or 31 instr.).
  82. .JMS  :  Own smaller , faster in loading , format. (See NSTTOJMS.COM)
  83. .SD2  :  Noise tracker format with 15 instruments.
  84. .SD4  :  Noise tracker format with 31 instruments.
  85. .JMQ  :  Old format (Private , for old songs) , not important.
  86.  
  87.  
  88. An example of a JMPROG file :
  89. -------------------------------------------------------------------------------
  90. ' This is a example of a JMPROG file
  91. 'this is more comment !!
  92. R=A     ' The program repeats forever 
  93.  
  94. ' Main Title
  95. T="Titel of program 0 , for example ACID BOX , etc. "  
  96. ' Don't forget the closing quotes !!, if you do all this text will be taken as 
  97. ' a title too.
  98.  
  99. Q:\PATH0\PATH1\ACID1.NST R:2 T:"Some good acid first of Acid boys !!"
  100. Q:\PATH0\hiphop0.jms t:"Hahahahahahaha Hip Hop !!" 
  101.  
  102. ' End of file.
  103. -------------------------------------------------------------------------------
  104.  
  105. See JMPROG.0 for another example !
  106.  
  107.  
  108. Part 3 : Keys.
  109.  
  110. While the program plays can be used.
  111.  
  112. ESCAPE : Exit to dos.
  113. F1     : To pause the song and equalizer, F6 continues, F2/F4 are still active
  114. F2     : Stop playing, F6/F4 to continue , 0..9 to select new program.
  115. F3     : Increases repeat-times of current song, from 0..A, after A comes 0
  116. F4     : Loads next song of current program.
  117. F5     : Decrease track and start at the beginning of that track.
  118. F6     : Play, only after F1/F2.
  119. F7     : Goto next track and start at the beginning.
  120. 0..9   : Select program number , only after pressing F2.
  121.  
  122.  
  123. Part 4 : Command line options.
  124.  
  125. Possible options : /O:n, /I:n, /F:name, /P:n
  126.  
  127. /O:n    , n is the middle digit of the I/O adress of the Sound Blaster card.
  128.           n between 1 and 6 , default is 2.
  129. /I:n    , n is the IRQ number of the Sound Blaster card.
  130.           Possible options : 2,3,5 and 7.
  131. /F:name , name is the filename of your own CT-VOICE driver , the program will
  132.           get your I/O and IRQ number information from that file.
  133. /P:n    , n is the program number to start with , n between 0 and 9 , def. = 0
  134.  
  135. Note 1 : The program will autom. search for the file CT-VOICE.DRV in the current
  136. directory. Use /F when the file has an other name.
  137. Note 2 : /O & /I have no function , when there is a CT-VOICE.DRV file in the
  138. current directory.
  139.  
  140. Part 5 : Specifications
  141.  
  142. This program needs :   - A Sound Blaster card
  143.                        - A EGA/VGA with 640x200 16 colors
  144.                        - An AT , (8 Mhz. higher)
  145.  
  146. The last , because the program recalculates the frequencies and joins them 
  147. together. This takes a lot of time. But JM is working on a new version for all
  148. PC's.
  149.  
  150. Of course J.M. and U4C take no responsibilities for any kind of damages this 
  151. program may cause (Which won't happen , if you do everything right !)
  152.  
  153.  
  154. Part 6 : About Ultra Force and addresses
  155.  
  156. Ultra Force exists of eight computerfanatics, which aim to make games
  157. and try to make them in their eyes perfect. 
  158. To create perfect code we make demo's to determine the limits and get more 
  159. experience. This demo is an example of what we can do with the Sound Blaster.
  160. With this demo we try to get some attention of Software Houses. 
  161.  
  162.  
  163. Our BBS      :  Holland 70-358.51.09  /**\ 300/1200/2400 baud  24 hours
  164.  
  165. Our P.O. Box :  P.O. Box 63048
  166.                 3002 JA Rotterdam
  167.                 Nederland
  168.  
  169. If you think you have good idea's, tips, graphics, prg's, music then 
  170. call or write to us.
  171.  
  172. Also you can find a lot of music files on the BBS !!!
  173.  
  174. Ultra Force Software Development :
  175.  
  176. - Remco de Berk                 - Michel Hooymans 
  177. - Josha Munnik                  - Bram Graveland
  178. - Eric Oostendorp               - Eric Soonius
  179. - Wido Riezebos                 - Arjan Brussee
  180.  
  181. Part 6 : The end.
  182.  
  183. The END !!!!!!!!!!!!!
  184.  
  185.